Skip to main content

Payload Format of tag L



Depending on the number of detected BLE Beacon(s), the payload size varies between 11 - 46 bytes (1-6 APs). If there are more than 6 BLE Beacons the messages will be split into multiple uplinks.

The Total messages indicate how many uplinks are expected.

and the #Message indicates the current message out of all the uplinks.

Scan pointer is incremented with every measurement.

ByteSizeDescriptionFormat
0-12Scan pointeruint16
21Total messagesuint8
31#Messageuint8
4-96Mac16 x uint8
101Rssi1int8
…
6MacN6 x uint8
1RssiNint8
ByteSizeDescriptionFormat
0-34Localization interval while moving, IMuint32, s
4-74Localization interval while steady, ISuint32, s
8-114Config/Status interval, ICuint32, s
12-132GPS timeout while waiting for fixuint16, s
14-152Accelerometer wakeup thresholduint16, mg
16-172Accelerometer delayuint16, ms
181Device state (moving = 1, steady = 2)uint8
19-213Firmware version (major,;minor; patch)3 x uint8
22-232Hardware version (type; revision)2 x uint8
24-274Battery “keep-alive” message interval, IBuint32, s
28-292Batch sizeuint16
30-312Buffer sizeuint16

Status[6:2]​

Status is only sent after a Config Downlink as an acknowledgement in the next Uplink. 4 bit [6:3] conf_change_id plus 1 bit [2] for success (=1) or failure (=0). conf_change_id counter resets after reaching 15 (1111).

Depending on the number of detected WiFi Access Points (AP), the payload size varies between 8 - 50 bytes (1-7 APs).

ByteSizeDescriptionFormat
01Status[6:2] + Moving flag[0] (moving = 1)uint8
1-66MAC16 x uint8
71RSSI1int8
…
6MACN6 x uint8
1RSSINint8
ByteSizeDescriptionFormat
01In case of a button-press 0x01 is sentuint8

Upon button press, trigger a location acquisition process. (if it is not running already!)

Depending on the number of detected WiFi Access Points (AP), the payload size varies between 12 - 47 bytes (1-6 APs).

ByteSizeDescriptionFormat
0-34Unix TSuint32
41Status[6:2] + Moving flag[0] (moving = 1)uint8
5-106Mac16 x uint8
111Rssi1int8
……
6MacN6 x uint8
1RssiNint8
ByteSizeDescriptionFormat
0-12Scan intervaluint16, s
21Scan timeuint8, s [0..180]
31Max beaconsuint8
41Min. Rssi valueint8
5-1410Advertising name/eddystone namespace filter10 x ASCII or
10 x uint8
15-162Accelerometer trigger hold timeruint16, s
17-182Accelerometer thresholduint16, mg
191Scan mode0 - no filter;
1 - advertised name filter
2 - eddystone namespace filter
20-212BLE current configuration uplink intervaluint16, s
ByteSizeDescriptionFormat
01Status[6:2] + Moving flag[0] (moving = 1)uint8
1-44Latitudeint32, 1/1’000’000 deg
5-84Longitudeint32, 1/1’000’000 deg
9-102Altitudeuint16, 1/10 meter
11-144Unix TSuint32
15-162Batteryuint16, mV
171TTFuint8, s
181PDOPuint8, 1/2 meter
191#satellitesuint8
ByteSizeDescriptionFormat
01Status[6:2] + Low battery flag[0] (low = 1)uint8
1-22Battery voltageuint16, mV

Combined uplink is used when there are ≤4 WiFi AP detected (7-28 extra bytes) && there is GNSS fix available && WiFi scanning is enabled.

TTF is the time it took the GNSS receiver to create a fix. We use this date to establish the timestamp for the WiFi scanning outcome. Timestamp for the WiFi scanning is TSGNSS – TTF + 10 seconds.

Depending on the number of detected WiFi Access Points (AP), the payload size varies between 27 - 48 bytes (1-4 APs).

ByteSizeDescriptionFormat
01Status[6:2] + Low battery flag[0] (low = 1)uint8
1-44Latitudeint32, 1/1’000’000 deg
5-84Longitudeint32, 1/1’000’000 deg
9-102Altitudeuint16, 1/10 meter
11-144Unix TSuint32
15-162Batteryuint16, mV
171TTFuint8, s
181PDOPuint8, 1/2 meter
191#satellitesuint8
20-256MAC16 x uint8
261RSSI1int8
…
6MACN6 x uint8
1RSSINint8

Depending on the number of detected WiFi Access Points (AP), the payload size varies between 14 - 49 bytes (1-6 APs).

ByteSizeDescriptionFormat
0-12Buffer leveluint16
2-54Unix TSuint32
61Status[6:2] + Low battery flag[0] (low = 1)uint8
7-126Mac16 x uint8
131Rssi1int8
…
6MacN6 x uint8
1RssiNint8
ByteSizeDescriptionFormat
0-12Buffer leveluint16
21Status[6:2] + Low battery flag[0] (low = 1)uint8
3-64Latitudeint32, 1/1’000’000 deg
7-104Longitudeint32, 1/1’000’000 deg
11-122Altitudeuint16, 1/10 meter
13-164Unix TSuint32
17-182Batteryuint16, mV
191TTFuint8, s
201PDOPuint8, 1/2 meter
211#satellitesuint8

Depending on the number of detected WiFi Access Points (AP), the payload size varies between 29 - 50 bytes (1-4 APs).

ByteSizeDescriptionFormat
0-12Buffer leveluint16
21Status[6:2] + Low battery flag[0] (low = 1)uint8
3-64Latitudeint32, 1/1’000’000 deg
7 104Longitudeint32, 1/1’000’000 deg
11-122Altitudeuint16, 1/10 meter
13-164Unix TSuint32
17-182Batteryuint16, mV
191TTFuint8, s
201PDOPuint8, 1/2 meter
211#satellitesuint8
22-276Mac16 x uint8
281Rssi1int8
……
6MacN6 x uint8
1RssiNint8


Default values for Batch size is 10, for the buffer size it is 8128 (maximum amount of data that can be buffered).
Maximum value for Batch size is 50. If Batch size is set to 0, buffering is disabled.

ByteSizeDescriptionFormat
01BLE advertisement (disable = 0, enable = 1)uint8
11GPS (disable = 0, enable = 1)uint8
21WiFi (disable = 0, enable = 1)uint8
3-64Localization interval while moving, IMuint32, s
7-104Localization interval while steady, ISuint32, s
11-144Hearbeat interval, IHuint32, s
15-162GPS timeout while waiting for fixuint16, s
17-182Accelerometer wakeup thresholduint16, mg
19-202Accelerometer delayuint16, ms
21-244Battery “keep-alive” message interval, IBuint32, s
25-262Batch sizeuint16
27-282Buffer sizeuint16
ByteSizeDescriptionFormat
01Time to buzz (buzzer off = 0)uint8, s
ByteSizeDescriptionFormat
010x00 - Off; 0xDE - Erase flash and Offuint8
ByteSizeDescriptionFormat
01Accuracy enhancementuint8, s [0..59]
ByteSizeDescriptionFormat
010x00 - Erase flashuint8
ByteSizeDescriptionFormat
010x00 - diasble, 0x01 - enableuint8

Payloads use big endian data encoding.
The Advertising name filter string must be zero-terminated. (0x00). This condition does not apply to filtering enabled for eddystone namespace (Scan mode: 2)

Min RSSI value is a signed integer and uses two’s complement for encoding.

If Min RSSI value is 0, there is no filtering applied for RSSI.

If Max beacons is 0, there will be no limit of how many beacons will be sent.

If Scan time is 0, there is no scanning performed on the device.

ByteSizeDescriptionFormat
0-12Scan intervaluint16, s
21Scan timeuint8, s [0..180]
31Max beaconsuint8
41Min. Rssi valueint8
5-1410Advertising name/eddystone namespace filter10 x ASCII or
10 x uint8
15-162Accelerometer trigger hold timeruint16, s
17-182Accelerometer thresholduint16, mg
191Scan mode0 - no filter;
1 - advertised name filter
2 - eddystone namespace filter
20-212BLE current configuration uplink intervaluint16, s
ByteSizeDescriptionFormat
010x01 - Trigger BLE scanuint8